Description

Starts a managed task as if it were triggered. All managed task properties will be utilized including Run As, Priority and Security.

Practical Usage

Used to cause another task to trigger. When a task is triggered, all of the parameters in the Task Administrator Task Properties are applied.  

IMPORTANT NOTE: This is not the primary means for starting a synchronous subtask (a much more common scenario), to simply start a subtask use the Start Task Action instead. The Start Task action contains much greater capability in terms of error handling and passing variables to the subtasks.

This action should only be used when the started task should run asynchronously (execution of the parent will not wait for the sub task to complete) and the other managed task properties such as Priority should be applied.

Parameters

General Tab

Managed Task to Trigger

Text, Required
MARKUP:
a) MANAGEDTASK="Talking Clock"
b) MANAGEDTASK="Foldername\Talking Clock"
 

Specifies the name of the managed task to trigger. The task must exist in the current machine task list at runtime or the step will fail.  
NOTE: changing the task name or parent folder name later can break this linkage once created.

Run Password

Text, Optional
MARKUP: PASSWORD="mypassword"
 

If the task has been encrypted, specifies the password that .should be used to decrypt it so that it can start.

Notes

Standard Error Handling Options
This action also includes the standard "Error Causes" and "On Error" failure handling options/tabs

More on Error Handling Options

Variables and Expressions
All text fields allow the use of expressions by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, a popup expression builder is available in all these fields by pressing F2.
More on variables...
More on expressions...
More on the expression builder...

Example

<AMTRIGGERTASK MANAGEDTASK="Sample Tasks\Custom Functions - Square Number">